Move Outlook Mail Message

Certainly! Here's the help documentation for the "Move Mail Message" activity:

# Move Mail Message

`AutomatR.Outlook.MoveMailMessage`

The "Move Mail Message" activity in AutomatR is part of the Outlook activities package, facilitating the movement of an email message from one folder to another in Microsoft Outlook. This activity enhances email organization within automation workflows.

## Properties

| Name                     | Description      |
| ------------------------ | ----- |
| ***Input***              |   |
| Account Name             | Specifies the name of the Outlook account from which the email message is to be moved. If not specified, the first account in Outlook will be used. |
| Destination Folder Name  | Specifies the name of the destination folder where you want to move the email message.                          |
| Mail Message             | Specifies the email message (MailItem object) in Outlook that you want to move to another folder.              |
| Select Destination Folder| Specifies the type of default folder or destination folder to select. You can choose from the available default folders in Outlook or provide a custom folder name. |
| ***Misc***               |    |
| Display Name             | Provides a customizable name for the activity displayed in the workflow. The display name enhances clarity and organization within the automation project. String variables containing the desired display name. |
| ***Optional***           |    |
| Delay   | Enter the wait time in seconds (Example: 5 seconds, i.e., 5) to start the activity.  |


## How to use:

1. Drag and drop the "Move Mail Message" activity onto the workflow.
2. Configure the properties by specifying the Outlook account name, mail message, destination folder name, and select destination folder type.
3. Optionally, configure the delay and customize the display name.
4. Execute the workflow to move the specified email message to the designated folder in Outlook.

## Example:

Consider an example where the "Move Mail Message" activity is used to move an important email to the "Archive" folder:

```plaintext
Move Mail Message:
  Display Name: "Move Important Email"
  Account Name: "PrimaryAccount"
  Mail Message: importantEmail
  Destination Folder Name: "Archive"
  Select Destination Folder: Custom

In this example, the activity moves the importantEmail to the "Archive" folder within the specified Outlook account. Adjust the details and options based on your specific use case.